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EPITORI AL 
Even if this is usually the one section in the newsletter you don’t 


1. As editor, the Users Group has been reimbursing me the cost of 
consumables used in producing this newsletter, at the rate of $15 per 
issue. I am used te spending up to 10@ hours each month on preparing 
the newsletter plus related correspondence etc, must have a new 
iedidd ribbon every second month... In July 1982 1 tried to resign: 
ut no~one was willing to undertake the job. 


At the December committee meeting, Anton moved that consideration be 
given to increasing the 1984/5 fees by $10.00; most of which would go 
towards the Editorship, which may be an incentive to someone. Based 
on current membership this would be around $2,560-3800 in value. 
There are two variables in this amount - the number of members, and 
the effects of inflation etc on our Printer’s bill, plus that last 
year’s budget was based on 24 pages and now we are up to 32 pages! 


Bruce Wills is prepared to take up the Editorship on this basis - he 
needs, for instance, a printer better than a Creed teleprinter, and 
several other bits and pieces to maintain the current standard. 


HONEY 

e payment of Editor and resultant increase in fees is mooted above - 
if you object for think it’s too little), now is your chance to write 
in to say so. Time spent on the Users Group has been at the expense 
of our household budget -we’ve bought equipment, software etc that 
would not have otherwise been bought, and although being a housewife 
may not be a paid job, it saves money by use of sewing and Knitting 
machines, time to read supermarket specials etc!! The final factor in 
my repeated resignation is a ‘nom-masKable interrupt event’ in 5 
months (baby #3)). Given how much work is involved, no-one has been 
prepared to take up the editorship without receiving financial support 
of at least the magnitude suggested above. 


Although annual fees are set by am AGM, that will not be until after 
April, but renewal notices will need to be sent out before then (you 
do want an April mag in April don’t you?). Renewal notices will be 
sent out in April to everyone; if at the AGM the amount is voted to be 
different, people will be reimbursed or billed the difference. 


LOCAL GROUP MONEY 

If you are a local group who gets us to collect your levy for you, 
tell us soon how much you want for the 1984/5 year billing. 

If you are a local group who would like us to bill members in your 
area for local meeting costs, also let us Know. You also get a copy 


= 


of the membership form which has all those useful details such as who 
is prepared to help locally, or give talks etc, for each member. 


DUNEDIN: 

A Wellington member, Steve, is moving to Dunedin, and will be 
contacting some of you re the possibility of setting up local meetings 
(if you haven‘’t already got them). 


MISCELLANEOUS? 

MOLYMERX have sent us a capy of their software catalogue. They a 
$3.0@ for the initial copy, then update it freely when needed. I[t 
gives very full descriptions of programs available (within NZ, so 
especially for the many members who live some distance from a Beeb 
dealer, this would be a good way to Know more about what you 
contemplate buying. A dealer with the small NZ market cannot be 
expected ta stock every program available for the Beeb which you can 
then inspect in the shop before buying, so the detail in this 
catalogue would be a great help. 


ATPL, producers of a sideways ROM board for the Beeb, sent us a blurb 
sheet about it and their Eprom programmer and Northern’s EPROM 
erasers, Their price list doesn’t include overseas carriage. Of the 
iz extra ROM sockets it gives you, one can be defined as RAM, 


Took a while to click: I read even the adverts in UK Beeb magazines - 
and staring at me in the face was Wellesley St, Auckland - in the 
February ‘Micro User’! FG Software offering goodies to UK people! 
And wanting them. 


THANK YOUS: 
As retiring Editor, I should do my bit and say Thank You to all wha 
have contributed material, and to ali whe have co-operated and helped 


me in various other ways too. My husband especially is looking 
forward to getting at the computer now! 


I hope you will all suppert Bruce at least as well while he is Editor. 


ADVERTISERS INDEX: NEXT MONTH: 
Business Woridd i9 LOTS iitis 

FG Software 15 Data Generation 
Micrologic 2 Data Selection 
Mol ymerx 2? Input 

Pirimai Pharmacy 31 Hangman 


reviews of books 
" of software... 


+ HELP GIVEN: 


WORDWISE: 

Thanks to Jean and David who find the Wordwise GF"xxxx" command does 
work ~ how?: 

Files saved under Wordwise’s option i (or 3), cam be reached from the 
GF command provided they do not include any control codes (ie any 
commands sandwiched by an fi and f2 - they appear in green on a colour 
screen, whilst text appears in white), 


If a file has control codes in it, it should be saved using option &, 
then it too will lead in and be printed satisfactorily. 

Thank you to David, Tim, Lance, Tony, Neville, for your responses to 
the 6845 Cursor problem ~ Anton should now be an expert on this aspect 
of the chip, and elsewhere in the magazine is your explanation for all 
the others who were puzzled. 


A =r3c it a ars have had problems getting VIEW to print with their 
cassette-based system. After printing a few lines, it hangs up. In 
both cases, the cassette player has not had motor control operating, 
and although the computer has told the cassette player to wait, it’s 
still processing the first block it got, the tape player Kept on 
winding on, so that when the computer went to get block 2, it got the 
second half, or block 3, and was unable to use it. Solutions: 

i, enable moter contro] on your tape player if you can (see 
Classifieds for the cable) 

2. buy a tape player that will allow you to enable motor contro} 

3. buy a disc interface and drive!! 


DECEMBER ERRATA 

Some lulus, weren’t there! 

9.16 program line 4¢: VDU23,224,8F F,&EE,&CC &BB,ABBACC AEE &FF 
line 80: VDU23,224,8.00,&F F ROOF F &G0,RF F 800,88 F 

9.24 Micro-rhymes came from London, not Sendon: 

0.66: first diagram rin be: 


11181 
EO0OR 61881061 
gives {oi 
FIG.1 should be: 
CHR.¢1) 66811088 | . | 
EOR CHR.(2) 22299999 (shifted one bit right? 


GIVES CHR.¢3) BG811806 


There should also have been a listing of a program to generate VDUZ3 
codes included. Well put it in next month for you. 
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FOUR LETTER SURSING 
Thanks go to Lance, David, Tim, Tony; Neville who responded to 


‘Cursing the 48495’, The following is ai distillation of the 
contributions ~ by Anton, who had the initial problem. 


The 6845 CRTC chip is a general video control chip that controls 
horizontal amd vertical scanning, scanning types; cursor position, 
paging, scrolling, and even light pen operation. Busy little chip, 
isn’t it, 
Information is available from: 

Motorola 6845 Data sheet (from VSI Electronics) 

Synertee 6545 Data sheet (from Professional Electronics) 

The Advanced User Guide (from Whitcoulls and others) 

The BBC Micro Revealed by Ruston (fram Others and Whitcoulls) 

Beebug Feb’s3 


The Beeb has to work with the pecularities of the chip. The main 
problem is that it has i$ control registers, some of which are read 
only Gight pen), some are write only (scan and cursor control), and 
some are quite normal like ordinary RAM. To access these memories, a 
nineteenth memory has been added which is a register address. This is 
linked to register &FF@@ of the Beeb. So if you are interested in 
register 2 say, you put 2 into &FF@@, which means you can now read and 
write into the 6845 register 2 (by putting a number or reading it in 
&FF@i). Now &FF is way up in ROM territory which is supposedly not 
RAN, and therefore unchangeable. Not true. There are three special 
input/output pages up there, called FRED, JIM, and SHEILA (UG p.436). 
You can peek and poke Sheila if you wish, but the results could be 
unwanted. Best to use the official calis; in this case, not OSBYTE 
but VDUZ3: 

VDUZ3,4,R#,.D,8,9,3,0,6,0 

or more concisely with the semicolon format, 

VDU23; RH »D,8;038; 

R# is the number of the register of interest, D is a data number that 
you want to write into R#. You can send them as a pair using the 
semicolon method. Register 18 with data 32 corresponds to 10,32 or 
else 8202; (ie 256%32 + 1@) 


Of direct relevance to the cursor are registers 7, 10, and if. 
Characters are organised in rows, with up to 32 scan lines per row. 
Register 9 sets the number of scan lines. It is increased in 
text-only modes. (8&6) to. give -a spacing between the lines. Register 
i@ has 7 bits (numbered @ to 6 as usual). Bits @ to 5 set the start 
of the cursor position. 011 is a typical value, as that gives the 
bottom line of a. character... The other two combine to affect the 
cursor display: 


+ 
et te gt Oe Make me 


Bité BitS Cursor display mode 
9 Non~blink 

{ Cursor off 

@ Blink fast 

{ Blink slow 


pute gute ES ED 


Obviously if bit 5 is set and bit 4 isn’t (any number between 32 and 
63), then the result is mo cursor. So my original query about 
character 32 vs character 33 is simple. Characters are irrelevant. 
Both numbers turn off the cursor. A fast-blinking, single line cursor 
should be obtainable by: 

VDU23;10,71,0;0;0; (where 71 =1000111 binary) 

A thicker cursor is obtained in text only modes because there are two 
extra scan rows added, 





Scan line @ ; 
As an example, here is the 
character ‘A’, 

with the cursor at the base. ie 
The advantage of a blinking 
cursor becomes obvious. 

One could otherwise confuse 

it with a ‘B’ or an ‘8’. 

In text only modes, lines & and ? 
would be part of the cursor. 
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Register 11 is used to determine the end scan of the cursor, Tony K 
recommends experimenting, beginning with setting R#,D to 10,8 and then 
to 11,0. This gives a high non-blinking single line cursor, That is, 
it underlines the character above the current position. 


There are also *FX calis which give the following attributes to the 
cursor under 051.0+ 


KFXI54,15 cursor vanishes 
#FX154,47 cursor double normal width 
BFXI54,i44 cursor treble normal width 


#FX{54,235 cursor quadruple normal width 
on that these only work in Modes 4 to 7, with best results in Mode 


DISC POWER SUPPLY UNITS: & | 

Where can you get them from, or has anyone the details on how to make 
them up? A lot-of UK mags. are suggesting that by the time you run 
extra ROM or RAM boards etc off the Beeb’s own PSU, it will be running 
pretty hot (if at all), if you try to run single let alone dual drives 


aff itas well. ® 


HELP FPLEASE? 


Jean has ‘21 Games for the BBC Micro’, Its Noughts and Crosses 
program is supposed to draw the 4 grid lines with 4 pairs of commands. 
However the first pair 
1996 PLOT 4,450,99¢ 
1100 PLOT 1,0,6¢8 
do not produce a line, only a little dot down in the left hand corner. 
She can make it draw the correct line by repeating the two commands, 
as line numbers 1105 and 1106. But WHY?7? The two preceding commands 
are: 
1679 VDU2Z3;2262;0;850; 
1088 GCOL 0,2 
and you are in Mode 5 at this time. 


TAPE TO DISC? 

Three people have written in wanting to Know how to transfer 
commercial programs from tape to disc. The programs they quote are 
all Acornsoft. 

The August Beebug offers a way, and in the February ‘Micro User’ is 
the news item covering Acorn’s clobbering Personal Computer World 
(°65,008 out of court!) who did the same thing. Apparently Acorn are 
now going to sell disc versions of their software at half price to 
anyone who sends in the tape (original) to them. 


SHUGART FLOPPY DISK DRIVES FOR THE BBC MICRO 
Available NOW for the BBC MICRO these drives are the 
very latest in disk drive technology. 


The GHUGART SA465 is a double sided 8@ track drive 
capable of holding 4@@k using Acorns standard DFS. 


PRICES.. SA465 uncased ONLY $520 tax paid. 
Single drive cable $ 25 
Single joystick units $ 33 


FOSTAGE Drives (and extras) are sent by courier to 
anywhere in N.Z. for #6. 
Add #1 per order for seperate cable and 
joystick orders. 


— . P.0. BOX 58@ 
Miicrologic MANUREWA 


(9) 247-6786 a.h. 


se MOTOR ON AND OFF via OSBYTE 137 


Anton 

For those with cassette systems with motor control, it is handy to 

define +motcr@ and *motori into the soft keys. Rather than use two 
Keys, a single Key can be used that changes the motor status. The 
following two programs are each capable of doing it. Despite 
appearances, they really are identical. OSBYTE call 137 is used 
(U.G.p.433). The status is Kept in address &9@. When called, the 
program ensures the contents of &90 are 1 or @, changes them to 9 or 
1, stores a copy of the result back in &9@ then calls Osbyte 137. The 
program assembly has a final RTS to terminate the call. Any Key could 
have been defined this way. Program 1 uses Key 4; program 2 uses Key 


1@ REM x#¥4Assemb. Motor on_otf 


26 
38 PA&Pi 3891 
B69! OFT3 
49 {OPTS 8891 45 98 = LDA &98 
36 LDA &78 
8893 29 8) = AND Hf 
68 AND #1 
6695 49 Of  EOR #1 
78 EOR #1 8697 85 98 = STA 498 
BB STA &78 8 
8899 AA TAX 
96 TAX : 889A AP B89 = LDA #137 
+H nee ae ate 28 F4 FF JSR &FFF4 
ae B9F 48 RTS 
138 ] 
148 2&98=8 


156 ¥KEY4CALLA&S1 IM 
A quicker but obscure program is the following: 
1@ REM**#8M/c code Motor on-ot+ 


28 

3B NAB=R299BASE : (494485014981 
48 '89B=LBIAIAADB : 'SOC=RGBFFFAZB 
38 #KEY6CALL&91 IM 


Actually, it is program { fed in as machine code using plings. The op 
codes were simply read off the listing produced by program 1, in 
groups of 4 bytes, and the order reversed since pling puts low byte 
first. 


Either program could be made part of a larger Detine Keys program. 
Locations &9@ to 9F are reserved for Econet, which most of us do not 
have. Should this be wanted for.an Econetted computer, change every 9 
in program 1 that follows an & to a 7 (eg &91 -~- &7D 


CONTROLLING YOUR TV’s DISPLAY 
Neville T. Ch’ch 


Many of you ‘out there’, like myself, are using your tv set with the 
Beeb rather than go to the expense of a monitor (Wot if; says the Ed, 
you're like us, with NO tv? How do we Keep expense down?) This is 
fine, except sometimes you will find that the display may be 
off-centre, too far to the right or left, depending on the particular 
tv. Ihave managed to fix this using register 2 of the 6845 CRTC 


Register 2 controls the horizontal sync, or displacement of the 
display from the left-hand side of the screen. Normally it contains 
these values: 


MODES 6 TO 3 ~- 98 
MODES 4706 - 49 
MODE /? “ cos 


Try altering these values by a small amount (eg { or 2). You will 
find that decreasing the mumber will shift your display to the right, 
whereas increasing the number will shift it to the left. 
To write the value ‘x’ inte the second register, use: 
VDU230:2 sx +810 0,8 58,8 


OR 
VDU23 532 5x 103859; 


I have found for my tv; that VDU23;2,96,0;8:0; centres the screen in 
Modes @-3, VDU23;2,46,0;0;8; in Modes 4-6, and VDU23;2,50,0;9;0; 
centres Mode 7. However, different tvs may need different values, 
which you can find by experimenting, (E£d~ change the background colour 
so you can see where the ‘screen’ is on the screen easier for 
centring), 


For altering the display vertically, it is far easier to use the #TV 
command on p.23 of the Users Guide. After typing this command the 
display is altered the next time you press BREAK or change mode. 


ADVENTURING NOTE: 


Bernard H. (Hamilton) has completed The Castle of Riddles, and will 
offer help to any who are completely stuck. 

steve W. has got to the ending of Colossal Adventure, and reckons he 
can help anyone on that one. 


Reminder that he also wants to set up a group for Adventuring, and 
like-minded people should let him know at 61 Disraeli St, Auckland 3. 


IMPOSSIBLE COLOURS: 
G.C.F. 


In addition to the & ‘pure’ colours it is possible to add i24 
in-between shade fairly easily. To get a pink colour you combine red 
and white. Well; mot quite, you actually use red and white for 
alternate pixels in a checkerboard pattern. (This is one technique 
where a colour tv might give a better result than an RGB monitor’) 


This can be easily done by drawing dotted lines (PLOT21 - UGp.319%). 
ach line is drawn as 2 dotted lines offset by the width of a pixel 
(4 in Mode 1, or &@ in Mode 5). To avoid a vertical striping effect, 
we alternate the order in which we use the colours. 


The following program illustrates this technique. Using PROC.N10 
which does the actual colour shading (the mame has historical reasons 
~ change it to some more meaningful name if you wish). An array of 
Squares is set up then the colours are changed to show how various 
combinations look against different backgrounds. The program will 
take about S minutes to run through its paces. It may be more useful 
to change the program to allow the user to determine which combination 
ae colours are displayed. Others may like to try out the flashing 
colours! 


AF A 4 A a AV aF a af AV af AF af a af af AV a a 


AF A 
Hate OF FAME: 

PUBLISHER: GAME HISCORE SCORER 

Acorn Arcadians 12,648 Brett A. 
Castle of Riddles *¥done#* Bernard H. 
Countdown te Doom {27 TimR. 
Hopper 26,988 Brett A. 
Meteors 15,4688 Brett A. 
Monsters 21,288 Atha} 
Philasophers Quest 236 Judy 
Planetoid 286,716 Brett A, 
Rocket Raid 15,166 Brett A, 
Snapper 2u8 , 88g Susan 

32,668 Sarah (&yres) 

Super Invaders 19,618 Brett A. 

Prag.Pow Killer Garilla 91 , 888 Susan 

Level ¥ Colossal Adventure ‘too busy playing ta nate'’ 
Dungeon Adventure 336 Anne 
Snowball | ug Gavin 


rc Hatt OF FAME ‘ 
A A 
aA ar aC af af a Af AT a a AF AF AF AU a AP Av at af 


18 REM Impossible Colours 
26 NODE! 
i: VDU2Z3 314 8565838 


og REM Set up mixed colour squares 
68 FOR f4=1 70 3 

78 =6FOR JZ=8 10 3 

86 IF 1Ad=J4 THEN PROCLM{O(14, 04 328414, 256804 , 3284144288 , 2564014288) 
98 NEXT JY 

1880 NEXT IY 

148 

128 REM Now change actual colours 
138 FOR Cex = 8 10 ? 

146 «FOR C14 = 4 T0 7? 

158 FOR C24 = @ TO Cix 


148 FOR C3, = 8 TO C24 
176 IF NOT CC1A=C24 OR Civ=C34 OR C242094) THEN PROC change 
188 NEXT 3% 
196 NEXT £2% 
288 NEXT C12 
«248 NEXT (QZ 
228 END 


238 
248 DEF PROCM18(C1%,C2% ,LX% ,BYZ XZ, TY) 
258 LOCAL CAY,CBZ,T%, 1% 

268 CAY=C1Y 

278 CBY=C2/ 

288 FOR Y¥=BY% 10 TY% STEP 4 

298 GCOL 8 CAY 

309 MOVE LX, ¥% 

318 PLOT 21 ,RXY,Y% 

328 GCOL 8, CBY 

338 PLOT 21 ,LX%-4 YY 

348 | TY=CAY 

358 CAVECBY 

368 CBYETY 

378 NEXT YY 


388 VDU26 ae 
a ENDPROC Do-It-Yourself Beeblet Kit 


426 LOCAL dummy 


«438 YOULE 8 CO% 8: eee Oooo 
448 VOUT, C188} 


458 YDUI9,2,02738: eo 
468 YDULS 3, 03438; 
478 dunmy=INKEY (168) LET us Know how you see him on our cover 


488 ENDPROE 


iz FUN MATHS: 


Reviewed by Gio A. Waikouaiti 


SQUARE PUZZLES from Scorby Software, Main St, Flixtan, Scarborough 
YOi!L 3UB. #76 plus 21 p&p 


This tape (for Model B) contains four maths games, each a variation on 
the ‘magic square’ theme, in which a grid containing number patterns 
is to be completed. The reward for completing the task, differing in 
every game, could be the rescuing of a girl by helicopter, ring a 
bell, or save a parachutist from a masty fall. The graphics, simple 
but effective, are accompanied by sound effects that can be turned off 
when necessary, 


The purpose of the games is to improve mental arithmetic (tables) for 
those aged 7~13 years, and to cater for the ability differences. Each 
game has a range of difficulties, and sometimes a range of grid sizes. 
However, in general classroom use I wouldn’t attempt to ask children 
younger than & years to cope with it, and believe it would be of most 
use ina class of 16-11 year olds. 


Instructions preceding each game are clear and it took a group of 
children a very short time to work out how to play. Reading skills 
would have to be; again; at about the 9-1@ year level. The program 
moves easily from instructions to a friendly scoring system at the 
end, and if you "give up", the answers are displayed, with 
explanations in some cases - a good feature. My only gripe is that 
when figures are displayed in columns, single figures are placed in 
the tens column which is a little confusing for adding and subtracting 
(for me anyway). 


Comments from the children, even though they were brought back te 
school during the holidays, were favourable - "It’s fun", "You Know 
Ale away when you’re right or wrong", "Can we use it in achool 
ime?", 


My choice of the four games is PATTERN in which logic, number pattern 
sHills and basic facts can be taught more efficiently and easily than 
1 could from a book or blackboard. A library of these sorts of 
programs would be very valuable in a primary school, although I see 
that Scorby Soft’s catalogue lists only one other for this age group - 
"Invader Maths” at £74.00 (plus £1 p&p) | 


(Anyone wanting to find out what else Scorby Soft are offering could 
a an sae to the Users Group - it’ll be cheaper than airmailing UK - 
qd) 
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199 PROGRAMS is 
Reviewed by Anton 


GORDON, John. 100 Programs for the BBC Microcomputer. pub 
Prentice~Hall & Acornsoft 1983 2609p, pap $26.99 


The author is an enthusiast. Anyone who can recommend the Beeb as a 
Kitchen timer has got to be Beeb-crazy' Unfortunately, he is a 
developing enthusiast who has published a compilation of programs 
which are largely of mediocre quality, and do not serve as good 
programming models. Some idea of his methods can be seen in his 
suggested Key definitions for program development: NEW is defined (but 
should seldom be needed); but BREAK has not been redefined with OLD. 
PROCedures are rarely used. This is annoying if, say; one wanted to 
use the mean and standard deviation as part of a larger program. He 
hasn’t provided a simple facility for removal or transferral, He also 
appears to program first and think afterwards. Quite clumsy methods 
are used in some programs, and these cause bugs. 


The good thing about the beok is that there are indeed lots of 
programs om lots of topics. As a source book of ideas it has merit. 
Teachers could use it as a "Fix the following program" source. And to 
historians in future decades, when trying to trace the course of the 
momentous computer explosion of the ‘30s, his book will be a source of 
unedited programs, e‘ll have wiped ours out with "improved" 
versions! 


(For those of you who wonder if Anton has ever found a book he likes, 
await next month’s mag! - Ed.) 


 <ES> Ae 


LITLE HINT 


RESTORING THE CURSOR: - Tim W., 
While developing a program recently I needed to turm the cursor off 
for a section of the program, then restore it later. On p.7?7 of the 
Users Guide, I learnt that the cursor could be reinstated by a mode 
change (OS 0,1). However I did not want to clear the screen. 


] ee the answer in Jeremy Ruston’s book "The BBC Micro Revealed" 
o restore the cursor after deleting it by VDU23;&202;0;0;6; use: 

modes @ to 6: VDU23;10,103,0;0;0; 

mode 7 VDU2Z3;10,114,0;0;0; 


1 <4 
ADVANCED GRAPHICS 


Reviewers Tim W. 


Angell & Jones. Advanced Graphics with the BBC Model B Microcomputer. 
pub. McMillan $37.95 


Most users of a BBC micro have more than a passing interest in getting 
to grips with the excellent graphics capabilities of their machine, 
whether for the purpose of presenting a lot of information in a more 
intelligible form, or writing the ultimate arcade game, or 
constructing 3-D views, or even listing a program sideways in rainbow 
colours! This book will help you do all of these things, and a lot 
more besides. 


It covers a number of topics that fall under the broad heading 
"GRAPHICS". There is extensive treatment of a method of drawing 2- 
and 3-dimensional objects, and the associated problems of perspective 
and hidden lines in solod objects. This occupies about half the book, 
Other chapters cover production of character graphics, Mode 7, and 
diagrams and data graphs. Another chapter details miscellaneous 
interesting graphics techniques such as scrolling, and changing the 
print vector to allow a custom-designed printing routine. 


Throughout the book the text is supplemented by numerous examples in 
the form of program listings and screen dumps. Major program hstings 
are: a character generator which enables you to design, edit and save 
user-defined characters; a series of interactive programs for 
constructing rather superior graphs and charts easily; and a very 
large program for designing displays in teletext mode and displaying 
up to 20 of these pictures sequentially to achieve animation effects. 
There are also some very useful listings which are unexpected: for 
example, a disassembler written in machine code, and a routine which 
enables you to search through a BASIC program to locate and alter 
specific variables and text strings. 


According to the book these programs are available on a pair of 
cassettes, but I was told that they would not be stocked in NZ. They 
could be ordered, but at a cost similar to that of the back. At least 
the listings in the book are very clear, and I haven't found any 
typographical errors yet! There is also an excellent index, and a 
separate index of the PROCedures listed in the book, 


Now some words of caution. The book is of use to those who have a 
cassette-based system (like me), but obviously it will be faster to 
have discs, especially since a lot ‘of *SPOOLing is involved. Also it 
is an advantage to have O51.@ plus. The book is not really suitable 
for beginners, as it assumes a fairly detailed Knowledge of Basic, not 


1S 


to mention Assembler. It would pay to be familiar with matrix 
mathematics if you want to follow the chapters on 2- and 3-dimensional 
drawing, at least at the first and second readings. Explanations are 
brief but adequate: the book covers a lot in its 270 pages. If you 
want a less complex book, you would be better advised to consider such 
a book as Steve Money’s ‘BBC micro graphics and sound’. By way of 
example, Money’s book devotes 6 pages to drawing circles; in ‘Advanced 
Graphics’ this sort of Knowledge is largely assumed. 


One last gripe. The final chapter describes the design of a 
fast-moving arcade game, and gives several interesting machine-code 
subroutines to whet your appetite. But there is no listing! If you 
want to get the game, you must buy the tape. 


Overall, this is a very interesting book that will be invaluable to 
anyone wanting to exploit the BBC’s graphics capabilities. The review 
copy was supplied by Whitcoulls; I will not be returning it! 

(They will get a small piece of paper though - Ed) 
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eG FG 
-G FG Software FO Box 6662 Auckland FS 
FR. FS 
Po Two adventures suitabie for the FG 
Pr moawice but will provide a challenge to F6 
Po the evperienced adventurer as well FG 
FG FG 
FZ -FIRATE ADVENTURE......5¢@k out the lost F6 
cg gold of Captain Flint. FG 
FG -VAMFTRE ADVENTURE... Solve the mystery FG 
ae of the "“Count*s" castle FS 
FiS Both $19.98 or $24.95 on disk FG 
FG -SHUMWART MENU FLANNER (just arrived!) FG 
FR -?47 FLIGHT SIMLILATOR (DOCTOR SOFT? | ee: 
Fi> -GORF 4 different screens of machine Fis 
FS code invaders! FS 
FG Ail $24.95 (cassette! $22.95 (disk) FG 
aks . Fuld range of Acorn,IJk.Micro Power FE 
FS (send SAE for our FREE catalogue) FG 
FG WE WILL SELL YOUR FROGRAM FOR you FG 
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is BCPL. - AN INTRODUCTION 


DUNCAN McE Wgtn 


This article is intended to provide an brief introduction to the 
programming language BCPL. A follow up article will review the BCPL 
System available for the BBC micro. Before discussing the language, I 
will briefly describe it’s main aims, to give you some idea of the 
reasons behind its more unusual features. 


eAnquace Backgrounds 
was developed in 1967 at London and Cambridge universities, as a 


language for systems programming. At that time, assembly language was 
usually required for such tasks, since the high level languages 
available were not efficient or flexible enough. BCPL is usually a 
compiled language {a program Known as a compiler must analyse the 
source program, converting it to machine code, before it can be run). 
This is in contrast to an interpreted lanquage such as BBC Basic, 
where each source line is converted te machine code as the program 15 
running. 


Im order to allow the BCPL compiler to generate efficient machine 
code, the language was deliberately Kept small. One way this was done 
was to only have one simple data type - the bit pattern - but to 
provide enough primitive operators to manipulate it in any way 
required. As well as the usual arithmetic and relational operators, 
BCPL allows bit manipulation and has an indirection operator (like ! 
in BBC BASIC). It also has an operator for finding the memory address 
of a variable, These latter two operators combined, allow 
manipulation of more complex data. 


Supporters of BCPL claim that this approach gives a programmer freedom 
to choose the best way of doing something, rather than having to 
accept an inappropriate choice by a compiler. They say that BCPL is 
an ideal combination of a high level language, with assembly lanquage, 
since it offers many of the advantages of the former, together with 
the freedom, flexibility, and efficiency of the latter. 


compenente of a Program. 
program consists of routines (similar to BBC BASIC PROCs) and 


functions. The method’ of declaring these will be illustrated later in 
an example program. One of the routines in the program must be called 
‘start’ - wher you run the program this routine is called 
automatically. 7 


ere comman’ss 
e simples PL commands are calls to other routines in the program, 


1? 


or assignment statements. A routine is called by using its name, 
followed by its parameters in parenthesis. If the routine does not 
have any parameters, empty parentheses are required. The rules 
concerning the use of parameters are identical to BBC BASIC’s. 


The general form of an assignment statement is 


Vis V2; ane j Vin = Ei, M2 wae En 
(nis usually 1) 


which assigns the the value of expression Ei to variable Vi, E2 to V2, 
etc. As in BASIC an expression may be as simple or complex as 
required. It may contain variables, constants, any of the operators, 
and calis to functions (similar to routine calis described above), 


BCPL also offers several ways of specifying loops and conditional 
execution. The general forms of these commands are given below. In 
each one, E is am expression, which will evaluate to true or false, 
and C, Ci, ete is any single command ~ including another conditional 
or looping command. In addition it is a general rule that wherever 
one command is allowed, a compound command {several commands enclosed 
in ${ and $) section bracket symbols) can be used. 


The conditional commands are : 
IF E THEN € (if E is true do 0) 
UNLESS E 0G € (i4 E is false do C) 
TEST E THEN CY ELSE C2 (34 E is true do C1 otherwise do C2) 


The leoping commands are : 


WHILE E DO ¢ (Test £. If true do C and repeat) 
UNTIL & DO C (Same as above, but if E is false) 

C REPEATWHILE E (Same as while, but do € at least once) 
C REPEATUNTIL E (Same as until, but do € at least once) 
FOR V= EL TO E2 BY K DOE (Same as BASIC FOR-STEP Joop) 

FOR Y= £1 70 €2 DOC (Same - but step is 1 by default) 


The Kin the ’BY K’ clause of the FOR loop must be a constant value. 


BCPL also has two commands which can be used to alter the control flow 
within a loop. BREAK causes control to resume at the first statement 
after the loop, and LOOP jumps directly to the loop test. These 
commands are restricted forms of the dreaded GOTO, and seo are 
considered less harmful! BCPL does have a GOTO command, but with such 
a wide range ‘of structured commands available the situation would have 
to be desperate for its use to be unavoidable! 


is 


BCPL is free-format, which means that all commands can be split over 
several lines, and indented in any way the programmer wishes, without 
altering their meaning. 


An Example Program. 

I have briefly covered the main features of the language, 80 now I 
will look at an actual program, to show how everything fits together. 
The program is a slightly modified BCPL version of the temperature 
conversion program from page 115 of the BBC Micro Users Guide. The 
modifications were sc I could use more features of BCPL. Note that 
a program uses integers since BBC BCPL does not support reai 
numbers. 


The ‘get’ command at the beginning of the program reads the file 
ibhdr’ (library header) from disk into the program when it is 
compiled. This file contains definitions for many useful library 
routines, and is used in most BCPL programs. 


The first routine or function declared in a program is introduced via 
the LET Keyword, and subsequent ones by AND. To declare a routine the 
teal is followed by the word BE. For a function, the symbol ‘=’ is 
used, 


The ‘=’ in a function header must be followed by an expression. The 
function ‘Kelvin.to.celsius’ illustrates this. However, it is often 
the case that a more complex operation is required as shown by the 
function ‘get.scale’. This is achieved via the VALOF command which 
can be used anywhere an expression is allowed. VALOF is followed by a 
Single command (usually compound) containing one or more RESULTIS 
clauses. Execution of a RESULTIS makes the following expression the 
value returned by VALOF. 


One command used below tin the routine ‘convert’} which 1 did not 
mention earlier is switchon. BASIC’s nearest equivalent is ON ... 
GOTO, The expression after SWITCHON is evaluated, and the matching 
CASE is executed, If none of the cases match, but there is a default, 
it is used, otherwise mo commands are executed. The one restriction 
is that each of the cases must be a constant. 


Finally, BCPL provides several standard routines and functions for 
doing 1/0. Those used’ below are: readn which reads an integer; rdch 
which reads a single character; writes - for writing strings; writef 
(formated write) which can write strings, integers in decimal, octal 
or hexadecimal, etc. 


pumary 
ave only been able to present the main features of the BCPL 
language. If anybody wants to find out more, they can try to get hold 


Businessworld 


COMPUTERS LIMITED 


li Johnstone Street. 
WELLINGTON 
OFF Featherstone Street 


LB 


Disk Upgrades I. 2 ROMs 

Pascal ROMs 400 Kb Diskett Drives 
View Word Processor 

Dot Matrix Printers from only $890. 00 
Daisy Printers from a mere $1, 830. 00_ 
And Lots More 


BUSINESSWORLO COMPUTERS LTD, 
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Wellington based service and maintenance 
for all of our customers 


Businessworld 
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of a copy of the book “BCPL ~ the lanquage and its compiler" by Martin 
Richards (one of the languages designers). I believe there is also a 
book available in England describing BBC BCPL, which may become 
available here. Finally, there is the user guide which comes with the 
BEC BCPL system. 


// # program to read in temperatures in Kelvin or Fahrenheit scales and 


// print cut the coresponding temperature in Celsius, =! 
| 
get *libhdr’ ff Get useful system definitions YF 
VF 

let start {) be 
${ iF 
let temperature, scale = ?, ? // Declare temperature and scale TF, 
// with unknown initial values F 
$( 1 
writes ("Enter temperature and scate : "> Fi 
temperature i= readn () // Library routine to read integer if 
scale m= get.scale ()  // My own routine - returns scale TF, 
convert (temperature, scale) TF, 
$) repeatwhile true if 
and convert (temp, scale) be IF 


// Do the conversion and write the result or an error message. The ‘tn’ Tf 
// in the write commands is BCPL notation for a new line. Without it, the fs 
// cursor is left at the end of the line just written (like a prompt). fF 
$< 


let converted = ? Hi 

if 

anes scale inte // Find out what scale temp is in. TF 

case ‘C’: case ‘c7: // Temp already in celsius so no _ 

converted := temp // conversion is required, fi 

endcase // Exit the switchon. (without this, the 1 

// next case would be executed as well) TF 

case ’F’: case 74’: Tf, 

converted 3= fahr.toscelsius (temp) if 
endcase 

i 

case °K’: case ‘K’: iF 

converted i= Kelvin. to.celstus (temp) Fi 

endcase Fi 

default; // None of the above so write an error message Fi 

writes (Invalid scaletn") TF, 


return // No conversion, so return to ‘start’. 

test converted < -273 then // Impossible to have temp colder 
, writes ("Temperature too cold for this universe! #n") 

else 


writef (ANAC is equal to UN’CHn®, temp, scale, converted) 


and get.scale () = valof 
A Reads characters, and returns the first non-blank. 


let ch = edch () // Declare ch and initialise to next 
. // character in input 
while ch= ’ 7 do // Read characters until a non blank fF, 
ch = rdch 0) 1% 
resultis ch // Return the character, ' 
| i 
and fahr.to.celsius temp) = (temp - 32) #5 / 9 1, 
and Kelvin.to.celsius (temp) = temp - 273 Fi 
TEXT COMPRESSION 


Tim L. of Nelson is toying with writing an adventure type game, and is 
at the point where text compression methods need to be decided on. He 
would like to Knew if anyone has gone through this before, or any 
other ideas - especially with figures on how much saving you can make 
by the second method offered: 


i. Using 5 bits for each character, a total of 32 characters 
available, with one for ‘Shift’ to move to alternate character sets 
lin the same way as the 5 unit Baudot(?) code for telegraph works) 
giving a total of 62 characters available. This would lead to a 
saving of about 37.5% in the memory needed to hold text, compared to 
one byte per character. The coding/decoding routine would also take 
SsOme space. 


2. feplace common words, combinations of letters etc with a shorter 
code ~ this seems to be the ei ahah Acorn used in Philosophers Quest. 
The savings with this method I can’t estimate. 


NB: Micro User has started an Adventure section from January on, which 
may also be looking at designing your own. The February Acorn User 
also has several competent articles on game designing and text 
compression. 


a2 COMPOSERS AD PLAYERS: 


Neil 6. — Mt Roskill 


I have been compiling a collection of recorder duets, using the Beeb 
aS a competent (if not virtuoso) player for the lower part. I have 
developed this program for practising and learning purposes. It sets 
up data files for each tune, or allows you to load in a particular 
file (tune). Input is easily achieved from printed music. If you 
Know the basics of reading music, this can be done very easily and 
quickly; if you don’t, it’s fun te try! 


When entering a new tune, it is advisable to play back your efforts 
every few bars when entering a tune, to correct any mistakes. 
Playback speed is widely variable, and uses the Beeb’s internal clock 
to control mote duration rather than the coarser i/2@th second 
increments used in the normal SOUND command. This allows you to input 
mote values other than the simple basics (eg triplets), Another 
playback feature is pitch control, enabling you to make 1/4 semi-tone 
adjustments to tune the Beeb to your instrument, or even change Key. 


The tune is repeated by pressing RETURN. By pressing SPACE while the 
music is playing; you return to the menu, allowing a restart or 
further changes to speed, pitch, envelope etc. 

In the listing, I have called PROCsave (saving a tune as a data file) 
twice - this is for those of us with @.4 OS and its cassette bug. If 
neither copy is satisfactory, type PROCsave and RETURN until 
successful. | 


Does anyone have any envelopes that adequately represent musical 
instruments? Envelopes 2, 3, & 4 are rather spurious! 


E£LEEEEL Pe ee LeeLee 
CLASSIFIEDS & DEALS; 


sd we _~ PACKAGE: Surplus to requirements. Book plus disc version 
on tape, orth, plus instructions to transfer to disc. 

$25.06 from David Jones, 44 Falcon St, Kaikorai, Dunedin. 

eeSeg ite eads to allow moter control (ie 7-pin DIN to 3 Jacks): $5.06 
plus o@c p&p. ph. Kevin Wgtn 845-243 or write c/- Box 9392 Wetn. 

ATES ~10s, boxed, leaderless ~- available from the User group in 
muitipies of 20 $24.68 plus $2.00 p&p. 


TELEPRIRTERS: Still available via the Users Group, $10 (plus carriage 
outside Wgtn!) 


Teleprinter paper - anyone can buy it from P.O. Stores! 


{@ REM: :COMPOSER: N.E.BAKER 8/83 

28 MODE? 

40 ENVELOPE 1,3,8,6,8,0,.6.8,121,-18,-5,-2,126, 126 

48 ENVELOPE 2,1,9,9,8,8,8,8.2,8,-18,-3,126,8 

5G EWELOPE 3,8,1,-1,1,4,1,1,121,-16,-9,-2,126,126 
4G ENVELOPE 4,1 .-2,-2,-1,5,5,5)8,-d yf 1,126,126 


74 DIM P(586) ,1. (588) 
Gb CLO:PRINT’’* "This program enables you to compose’ "single part music, play 
it, FILE it®‘*and retrieve it.’ 
9 INPUT’’"Name your TUNE * , tune$ 
188 Cé=8:E=-15 
118 PROCingtruct 
128 X=8 
136 PROCmenu 
148 PRINT “Do you want to save the tune Y/N? * 
{56 IF GET#"Y" TREN PROCsave:PROCsaye:REM delete second save i¢ 9938.1 
{68 END 
; 
188 DEF PROCcreate 
198 CLOsPROCStave Does a Beeblet look like this? 
min REPEAT! 
228 YeKtH + 
238 PROGHe i tei) 
a ia LUX)=6:REMenote of 8 Jength Well, Hawksbeeb does 
268 VDU 264 
278 ENDPROC 
288 


298 DEF PROCinstruct 

388 CLSIPRINT’‘*Enter rest as Note 2, Octave 1,"’"ftollowed by its length.” 
318 PRINT’ *Accidentals:"’"Enter 6# a 53°" ‘Enter Bb as BB" 

328 PRINT‘"Eb belongs to the octave BELGQW E natural® 

336 PRINT*Tied nates of same pitch should be"’"entered as one note’ 

348 PRINT’ "Note lengths can be fractional’’"e.g. triplet quaver = 1,33" 
358 PRINT’*To end, enter any note and actave*’ fal Loued by 8 length’ 
348 PRINT’ "press any Key to continue’ 

378 2=GET 

388 ENDPROC 

398 


d4@@ DEF PROCSt ave 

418 PRINTTAB( 28,13) 3° I= semi quaver® 

426 PRINTTABC 28 14) .°25 quaver’ 

436 PRINTTAB( 28,193 5° 4= cratchet® 

$48 PRINTTAR( 20,16) "R= minim’ 

459 FOR line=!T05 

448  PRINTTAB(28,] ine +18) STRINGSTL?7 71°) 

378 NEXT 

490 PRINTTABS 24,23) CHRS( 259) TABS SB 289: "8" sCHRS( 259) 


a +t 


496 PRINTTABC28 ,23)3"1" 

308 PRINTTABC 27, D1): ges 

318 PRINTTAB(34, 19) 983" 

328 PRINTTAB( 19,18) :"Octave- E to D 
{Eb)* 

338 ENDPROC 

546 

Ju8 DEF PROCwri te<X) 

368 REPEAT 

378 = PRINT’*Note "3X 

386 = INPUTnotes 

378 = REPEAT 

686 INPUT" Octave 1,2,3,4 *,oct 
418 UNTIL oct>@ AND oct<5 

$29 = PROCnote_to_pitch 

638 IF P= SOUND! ,~15,222,5 

648 UNTIL P56 

658 Pt(X)=P+48e(oc t-1) 

668 INPUT’Note length *,L«X) 

678 ENDPROC 


688 
698 DEF PROCnoteto_pitch 
788 P=8 


718 IF note#=*E" P=28 

726 IF noteg="F* P=24 

738 IF notes="F3" OR noted="GB" P=28 
748 IF notet="G" P=3? 

758 IF noteg="G3" OR noted="AB* P=3¢4 
768 IF nated="A* P=48 

776 IF note$="A3" OR notes="BR* P=44 
788 IF note$="B" P=4Q 

798 IF neteg="C" P=92 

888 IF note$="C3* OR noted="DB* P=54 
S18 IF noteg="D" P=ée 

828 IF note$="D3" OR note$="ERB* P=d4 
838 IF noteg="2* Pej 

ss ENDPROC 


3 
B48 DEF PROCsave 
878 CLO:PRINTTABC8 16) ;“Advance tape 
to blank portion and’’"press, RETURN": 
888 dumpy=GET 
898 EX= OPENOGUT tuned 
968 PRINT’*Please wait" 
918 PRINTHEZ,X 
928 FOR J=1 TO X 
938 = PRINTHEZ, PCJ), LOD 
948 = NEXT 
950 CLOSEHEZ 
968 ENDPROC 


978 

98@ DEF PROCToad 

998 PRINTTABCO 16); "Press any Key an 
d piay tape at"’"correct place for "3 
unes 

1806 Q=GET 

1838 PRINT*Please wait* 

1828 EXROPENIN tunes 

1636 INPUTHEA Xx 

1848 FOR J=] TQ xX 

1036 | INPUTHEZ, PCJ) Lad) 

1868 NEXT 

1876 CLOSEREA 

1888 ENDPROC 

1896 

1188 DEF PROCsetspeed 

1118 INPUT’“Enter crotchets per minut 
e*“* RETURN enters 188 "cpmrIF cpm<2@ c 
pm=1 88 

1128 ENDPROE 

1138 

1146 DEF PROGmusic 

1198 PROCsetspeed 

1155 wait=INKEY(18@):REM gives you ti 
me to pick up your instrument 

11468 PRINT’*You can interrupt the mus 
ic while"“*playing by pressing the SPA 
CE BAR" 

1178 J=} 

1188 WATT=INKEY¢ 188) 

1198 REPEAT 

$286 «= KEINKEY(8):REM allows music to 
be interrupted with space bar 

1218 IF P{J)={ THEN V=@ ELSE V=E 
1228 SONS WeP)Sehel 


UN 

1248 REPEAT UNTIL TIME D=TY 

1258 = SOUND&11 ,6,0,8 

1268 «= Je J+] 

1278 UNTIL JX OR k=32 

1288 ENDPROC 

{298 

1388 DEF PROCmenv 

1318 REPEAT 

1328 §6CL5 

1338. PRINT’ "RETURN- Play music*’*t. 
create NEW music’’"Z. change overall 
pitch"’"3, change envelope’’"4. displa 
y data*’"3, edit wrong note" 


1348 PRINT "6, add more notes*’°7, 
list instructions’/*8. load music’’*, 
save or end” 

1358 INPUT A 

1368 IF A=8 AND X)8 THEN PROCmusic 
$378 IF A=1 THEN PRINT “Are you sur 
e Y/N ? "rs1F GET$="Y° THEN X=8:PROCer 


pate 

1386 JF A=2 INPUT’*Enter 1,2,-1,72 
etc. "/"RETURN to restore original pitc 
h "CA:PROCmusic 

1398 IF A=3 INPUT’ “Enter envelope | 
52,3,4 *7*RETURN to cance) envelopes * 
E:]F E=@ THEN t=-15 


— 
1528 REPEAT 
1538 K=K+] 
1548 PROCconvert 
1599 IF GET PRINT "No.*3K;" *sNote$ 


* Oct "soctave;" Length ";L¢K) 


1548 UNTIL K=X 

1578 PRINT’*press RETURN to continue’ 
1589 REPEAT UNTIL GET=13 

1598 ENDPROC 


{468 

1418 DEF PROCconvert ~ 

{428 octaves(P(K)+28) DIV 48 

1638 basepi tch=P¢K)~(48#(octave~1)) 
1464@ Noteg="rest : 


1406 «IF A&3 PROGRusic 1458 IF basepitch=2@ Note$="E : 
1419 1F A&4 PROCdisplay 1468 IF basepitch=24 Notes="F : 
1428 IF A=S INPUT’"Enter number of 1678 IF basepitch=28 Notes="F& or Gb" 
note * N:PROCwr i te<Nd {488 IF basepitch=32 Note$="6 ‘i 
1438 «oF A=6 PROCcreate 1698 IF basepitch=34 Note$="G8 or Ab* 
1449 «so IF A=7 PROCinstruct 1788 IF basepitch=48 Note$="A . 


1458 iF A=8 THEN PROCload 
1468 UNTIL ADS 
1478 ENDPROC 


1480 

1498 DEF PROCdisplay 

{588 K=4 

{SiG PRINT"Press down any Key*’ 


1718 IF basepitch=44 Note$="A¥ or Bb" 
1728 1F basepitch=48 Notes="B 
1738 IF basepitch=52 Notes="C 
1748 IF basepitch=54 Notes="C# or Db" 
{750 IF basepitch=48 Note$="D 
1768 IF basepitch=44 Noted="D8 or Eb" 
1778 ENDPROC 


BBC MICROCOMPUTER S 2k 


As discovered by Tony K, Manurewa 
ARIES B2@ EXPANSION BOARD from Cambrid 
Cambridge CB1 1 BR. £794.06 ney eens 


Have you ever been writing a program to use Mode @ graphics and 

hit with the error message ‘Ne room’, Frustrating, tent it? When I 
Saw the advert in Acorn User for the Aries B2@ board I jumped with 
delight: here at last was the answer to my prayers. I rang Cambridge 
Computer Consultants’ that night and spoke to a very nice lady by the 
name of Vicki. She told me most apologetically that they could not 
sea eS gi I sent them a cheque for 298.06 to 

: rd and postage, they would send me 
did, and four weeks later This 2 B20 board. Se aa 


The board measures iS cm by & cm and sits over the 65¢2 socket insi 
nsid 

the Beeb. On the board are 1@ 2k x 8 static RAM chips (Hitachi 

6116-28), 12 assorted LS TTL chips and a forty pin socket. To install 


cae 


the board, all one has to do is carefully remove the 6502 processor 
from its existing socket. plug it inte the 4@-pin socket on the B2¢@, 
then plug the B20 board into the now empty 6562 socket on the Beeb’s 
main board. The ROM supplied with the unit 15 then plugged into a 
Spare paged ROM socket, and that’s it. Om turning on the Beeb you are 
now greeted with “BBC MICROCOMPUTER 52k’. 


How does it work? In the Beeb, video RAM and program RAM are one and 
the same. If you 9 into a high resolution screen, you lose program 
RAM space at an alarming rate. In Mode @ 20K is gobbled up by the 
screen, What the Aries B20 board does is give vou all the RAM back 
for program use. An additional block of RAM contained on the B2¢@ sits 
in parallel with the existing RAM. When the system accesses program 
RAM the control circuitry switches the B2@ RAM block into action, and 
Voila! 28K of RAM in any mode! The nicest thing about all this is 
that the switch is transparent providing your programs use proper 
operating system calls and do not access the screen memory directly, 
For those programs which do access screen memory directly (Acornsoft 
arcade games etc) the board can be disabled by typing in #XOFF. In 
Mode 7 of course, you only gain 1K of RAM? Wrong, dear friends: a new 
{Acorn-approved) function call #FXiii can be used to switch the two 
blocks of RAM. You may now store data using ?7,! and $ into either 
block and switch blocks at will... You cannot create large BASIC 
arrays using this switched RAM. 


Worth the money? A definite YES. I can now get on and write my iarge 
graphics programs without worrying about that annoying ‘No room’ 
message. My Mode @ RAM size just increased five-fold. 


Problems? A couple of minor ones: Cambridge Computer Consultants will 
not be selling the board through dealers, so you have to order the 
board direct from England; and the board uses space inside the Heeb 
usually occupied by my Watfords Electronics 13 ROM card. (I now have a 
{3 ROM card for sale. Takers? ph. (09) 267-6786). Cambridge are 
bringing out a 12 ROM card which will be compatible with the Bz@. 
Until they do, I have $ ROMs, two more on the way, and only four 


(Jan. Acorn User p.? also note that Ramamp Computers are producing a 
6-ROM card and a RAM card which will both fit under the Keyboard 
instead of over the main pcb. - would that help? - Ed). 





WANT PEOPLE CLAMOURING.TO.BABYSIT FOR YOU? 


Send Level ? in UK £9.98 for their latest adventure, Snowball! Wait 
a couple of weeks for it to arrive. Works for the editor anyway! 


BBC 


Molumerx 
The MOLYMERX COLOUR SOFTWARE CATALOGUE is ready ! 





Pages of descriptions of new powerful Application and 
Utility software for $3.00 


and THAT's NOT ALL ~- 


as we publish new software we send you free UPDATES. 
Our offer is to keep you abreast of NEW products, 
NEW services and our regular special prices, 


Some of the products in the latest edition of our catalogue ! 





UiISh FILE WAR bAMES 
True Random Access File DATABASE napoleon kgratere: “Bieperer 
SHUTTLE 34 OSA cAPRBNIONS TOR 
Fly COLUMBIA I from space to a Desert landing Gif you can 1) 
Please use BLOCK CAPITALS 
Name/Comparty ........ cc sececraseraevens 
Fil in the coupon and retum to: 
. AOCIOSS ia a cieMiiiieiest Se naiew vires 
Molymerx Ltd. 
P.0. Box 80-52 (wet terete nett ee eees GONG: ke scigsgediciwaads 
Titirangl, lenctose $ @ 94.80 per copy 
eee eek ” | : apniait 80 Cataloave 
Priel 2 Peer rere rer rss psa pi otal hor 
CA 
Wie (817) 4372 Mutraaslan tts fr. Aaa com Big Fe, CAM, 
bare Syston Murntond iMics Systerne, 
Software, ARC, Powers? { 


Please send (] copies of the 
Molymerx Software Catalogue. Dealer Enquiries Welcome 





THE MDMANCED USER GUIDE 
Reviewer: Neil 6G, 


Bray; Dickens and Holmes. The Advanced User Guide for the BBC 
Microcomputer. pub Cambridge Microcomputer Centre Sizp. spiral bound 


Review copy supplied by Whitcoulls. 


Before launching into what is a rave review of this book, I should 
caution that it 1s indeed a guide for the ADVANCED user of the BBC 
computer. For those users (perhaps 28% of you) who intend to program 
in assembly lanquage, delve into the operating system, or connect 
exotic hardware to the BRC, this book is indispensable. The other 80% 
of users have all the information they require in the USER GUIDE 
pee with the computer, supplemented by any of the numerous 
tutorial books on BASIC programming. 


The ADVANCED USER GUIDE is a perfect match in appearance and format to 
the supplied USER GUIDE, and contains almost as many pages. Four main 
topics are covered ~ operating system commands, assembly language 
programming, operating system interfaces, and hardware. 


A complete description of all the *# commands is contained in the 
section on operating system commands. Included are several new 
commands which until now have been documented only in various magazine 
articles ~ #HELP, #CODE, #LINE, and «ROM. The section on the *SAVE 
command also includes a previously undocumented parameter which allows 
you to specify a reload address for the SAVEd area of memory, 


Don’t expect to learn how te program in machine language from the 
section covering this. It is intended as a reference quide only. 
Once again, it covers topics which have hitherto only AEE in 
magazines - for instance, the EQUate facility in Level 2 BASIC, which 
allows space to be reserved for data with predefined values. 
Fifty-seven pages are taken up with a description of each of the 6362 
instructions. ach starts om a new page, which allows for quick 
reference to the required mnemonic, but does result in a fair amount 
of blank paper. For each instruction there is a complete listing of 
the resulting status of registers, and valid address modes and machine 
cycles taken for each. Surprisingly, the code number used for each 
instruction type and address made is not given; this vital information 
must be obtained from some other book. | 


The section on operating system interfaces is perhaps the most useful 
part of the book. Firstly, it contains complete descriptions of the 
operating system calls, including several calls which had only 


id 


appeared in magazines, and several that I had never heard of. A 
particularly interesting one is OSRDRM, which lets you read the value 
of a byte in any of the paged ROMs. (1 used that one to investigate 
and disassemble WORDWISE). 131 pages are taken up with descriptions 
of ALL the OSBYTE (#FX) calls, including many whose functions had 
previously only been guessed at by experimentation. 


This section goes on to describe all the OSWORD commands (nothing new 
here), It then gives a complete list of the vectors used to jump to 
various standard operating system routines. The advantage of Knowing 
these is that you can intercept a call to a routine by changing the 
appropriate vector (a two-byte address) to point te your own version 
of the routine. 


Next up is a memory map. As I have pointed out before, where possible 
you should use the appropriate operating system calls to access 
operating system parameters rather than relying on their being at a 
certain address. However, for parameters which aren’t accessible 
through calls, the information provided here will be invaluable. 
Furthermore, you can use the map to find areas of low memory which are 
usually safe to store your machine language or variables. For 
instance, did you Know that zero page locations &9@ to &9F are 
allocated to the Econet system? This, of course, means that most 
people will be able to use these locations for variable storage. 


The chapters on events and the RS423/cassette system are excellent, 
and include several sample programs illustrating the techniques - for 
instance, reading directly from the cassette port (it does work). 
Very full documentation of paged ROMs is given, followed by a chapter 
on BEC filing systems. The section on cassettes includes the now open 
secret on the bit that is set for “locked” files. 


The hardware section covers much the same ground as the "Expert 
Guide", but in much more detail, plus it gives information on the Tube 
and the 1 MHz bus. Also included is a circuit diagram of the BBC. 


Overall then; this is an excellent reference guide which combines in 
once neat package a lot of very useful information which, until now, 
has only been available in bits and pieces. I heartily recommend it 
for those users who need the Kind of information it provides. 


no = 


18 REM #4# GCOL 1,X AND GCOL 2,X DEMONSTRATOR - 
28 REN 84% BY TIM RYAN 
ra ON oo MODE 8 :END 


NODE 
+ DU 23,224 ,36,126,195,283,211,126,36,66 a> 
7 REM MAKE ALL THE COLOURS FROM 8 TO 15 DISPLAY WHITE 


98 FOR colour=8 TQ 15 
198 vol 19,colour,7,8,0 8 ~@ tf 


138 
128 
oF REM DRAW BLOCKS OF COLOUR FOR THE SPACESHIP TO FLY OVER 


136 FOR horiz_posit=144 TO 1888 STEP 144 
168 OF. @,horizposit DIY 144 

176 MOVE horiz.posit ,@:MOVE horiz.posit, 1688 

188 PLOT 85 shor iz_posit+128, 8:PLOT 85 hor iz_posit#128, {886 

198 ENE hor iz_posit DIV § 8: DRAA hor iz..posit DIV 9, 1688 

ne Ha 115éthoriz_posit DIV 9, B:DRAW {15éthoriz_posit DIV 9, 1888 


228 
rf REM NOW FLY THE SHIP OVER THE LANDSCAPE USING ORS AND ANDS 


258 VOU 5 

268 shipold.hpos=i sship.old_vpos=506 

276 Lo ship_horiz_posit=divert.dir=8:ship_vertiposi t=588 
288 REPEA 

296 

ni GCOL 2,7 : REM ‘AND’ WITH HIGH BIT RESET TO REMOVE SHIP 

eh MOVE ship.old-hpos,shipold vpos:VDU 224 

ee GCOL 1,8 : REM TO PUT UP SHIP i7 16 OR’D WITH BACKGROUND 

368 = MOVE ri aa ship.vert.posit:VDU 224 

278 IF ship-horiz_posit)i208 OR ship-horiz_posit(] THEN horiz.dir2-horiz.dir 
388 oF RND(18)=18 THEN vertodir=RND(3)-2 

398 oF ship_vert.posit(48 THEN vertdir=2 

468 IF ship.vert.posit>18i6 THEN vertidirs-2 

418 = ship.old_hpos=ship_heriz.posit:ship.old vpos=ship.vert_posit 
428 = ship_horiz.posit=ship.horiz.posit+Bthorizidir 

436 = ship_vertposit=ship_vertpositt+Sivertdir 


ip UNTIL INKEY(5)=32 
478 YDU 4 a2eae 


GCOL 1,.% AD GCOL 2x: 1 
TIM R, 


The following program is an experiment to allow a foreground abJect to 
be animated across a coloured background without either the foreground 
oer background changing colour as the foreground object passes by. | 
wrote it after seeing the experiments done in the December issue of 
the User mag where the GCOL 3,X statement was used. To me the most 
annoying feature of the XORing technique is that the foreground obJect 
changes colour as it passes over the varying landscape. This 
technique avoids the problem but as it is, limits the user to one 
fereground colour. 


However the book ‘Advanced Programming Techniques For The BBC Micro’ 
by Jim McGregor and Alan Watt gives a lot more information on this 
subject including a way to have five separate ‘foregrounds’ that do 
not interact with each other. Each plane may be independantly filled 
and cleared without affecting any of the others’ planes, either in 
front or behind. This gives an amazing effect and is really easy to 
control. For more on this I can really recommend the book mentioned 
above, The program runs as is; and may be developed as you like. To 
stop the animation, simply hit the <SPACE BAR>. Have fun! 


Can we help you with ttems for your B.B.C, 


SOFTWARE now in stock:- 
Most of the BBCSOFT and ACORNSOFT ranges 
The full I.J.K. range | 
MOLYMERX JUMBO and SPACE SHUTTLE 
For serious ap eceree consider the GEMINI range 
BEEBCALC EEBPLOT DATABASE MAILING L] 
STOCK CONTROL HOME ACCOUNTS EASILEDGER 
also CASHBOOK and FINAL ACCOUNTS 
Just Arrived is the impressive AB2 Designs PacKage 


HARDWARE Now Available:- 
Disc Drives $8 track Double Sided (468k) $888 
(these can be supplied with 48 track switch> 
Printer $738 
Acorn joysticks pair $55 
Almost Completed 14 Key programmable Keypad 


For further information contact: 
Bob Brady at Pirimai Pharmacy Ltd. 


Pirimai Plaza phone 4397616 
NAPIER 


2 
USER GROUP MEETINGS 

AUCKLAND:-meets 2nd Wednesday of the month, ¢.6@pm, VHF clubrooms, 
fee ogce Mt Roskill. ph. Dave 770-63@ x 316(bus) or Kerry 

HAMILTON:-last Wednesday of the month Spm Waikato Tech B-block 
staffroom. Ph. Peter, Hamilton 393-999 or Alison; 
Morrinsville 6675. 

TAURANGA:~every second Wednesday. ph. Chris & Jane 65-076. 

HAWKES BAY:-Alternate months Hastings & Napier, Contact Kendall 
aS a 435-624, Bob Taradale 446-955, Mitch Hastings 

TAUPO:-Contact David $4-2145. 

WELLINGTON:~meets LAST Thursday of the month, 7.20pm, Correspondence 
School Staffroom ({st floor), Portiand Cres, Thorndon. ph. 
Anton 286-289 or Warren 787-005. 

CHRISTCHURCH:-fortnightly workshops, Tuesdays 7.00pm at Hagley High 
School. ph. Michael 992-267. 

OTHER CENTRES:- let us Know to publish details here. 


THE NEWSLETTER: 

CONTRIBUTIONS:~- most welcome. a should be sent in on tape or 
disc. (Tape - Z copies, one at 300 baud please) A 35c stamp 
gets your tape / disc returned toc. Please include written 
explanation of listing; text-only material welcome too. 

DEADLINES:- For a particular issue, the last day for material is the 
last day of the month prior to the month of publication. 

ADVERTISING:- Rates are $20 per half page, deadline as above. 


Copyright (c) THE BBC MICROCOMPUTER USERS GROUP OF NZ INC. 
Published monthly except January and mailed to financial members. 


MEMBERSHIP: 
Membership of the users group is on payment of an annual subscription from April 
to March. For the 1983/4 year it is: $28.08, plus a $5.66 joining fee for new 
members, plus $5.88 for Auckland & Wellington members as a local Branch levy, 
which entitles attendance at meetings as detailed above. Renewing members get 
Sea na of the current year; New members get ALL back issues back to y.1 
an “83, 
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